home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_povray.idb / usr / freeware / catman / u_man / cat1 / povray.Z / povray
Encoding:
Text File  |  1999-04-16  |  28.5 KB  |  595 lines

  1.  
  2.  
  3.  
  4.      PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))          PPPPOOOOVVVV----TTTTeeeeaaaammmm ((((4444 MMMMaaaarrrrcccchhhh 1111999999999999))))        PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       povray - POV-Ray - Persistence of Vision Ray Tracer v3.1e
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       ppppoooovvvvrrrraaaayyyy [++++iiii _i_n_p_u_t__f_i_l_e] [++++oooo _o_u_t_p_u_t__f_i_l_e] [++++////----ooooppppttttiiiioooonnnn ...]
  13.       [_I_N_I__f_i_l_e ...]
  14.  
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.       PPPPOOOOVVVV----RRRRaaaayyyy is a free, full-featured ray tracer, written and
  18.       maintained by    a team of volunteers on    the CompuServe GO
  19.       GRAPHDEV Forum and on    the Internet.  On the Unix platform
  20.       PPPPOOOOVVVV----RRRRaaaayyyy can be either    a text-mode only program, or can
  21.       optionally have preview capabilities using the _X _W_i_n_d_o_w
  22.       _S_y_s_t_e_m.  Under Linux,    PPPPOOOOVVVV----RRRRaaaayyyy    can optionally use the SVGA
  23.       library to preview renderings.
  24.  
  25.       This manual page only    lists the basic    PPPPOOOOVVVV----RRRRaaaayyyy    and Unix
  26.       specific features and    command-line options for this version
  27.       of PPPPOOOOVVVV----RRRRaaaayyyy.  For a complete description of the features of
  28.       PPPPOOOOVVVV----RRRRaaaayyyy and its scene    description language, or for a better
  29.       explanation of the meaning of    the command-line and INI file
  30.       options, please consult the documentation that should
  31.       accompany all    versions of PPPPOOOOVVVV----RRRRaaaayyyy.  On some sites this will
  32.       be installed in /usr/freeware/lib/povray31.  Some of the
  33.       Unix specific    features are:
  34.  
  35.            Support for X Windows display automatically uses    the
  36.            best visual class and deepest depth available.  For
  37.            visuals that do not support 24 bits of color per    pixel,
  38.            Floyd-Steinberg error diffusion dithering is used,
  39.            along with a dynamically    allocated and optimized
  40.            palette to produce the best display possible with the
  41.            current visual, depth, and available colormap.
  42.  
  43.            ICCCM compliance    for the    X Windows version means    that
  44.            the preview window will behave like standard X Windows
  45.            programs, communicate properly with the window manager,
  46.            and will    accept the standard command-line options.  See
  47.            _X(_1) for    more information.
  48.  
  49.            Support for SVGAlib display automatically detects the
  50.            available SVGA display modes to choose the size which
  51.            best fits the rendered image.  When rendering an    image
  52.            that is too large for the current display, the
  53.            displayed image is scaled to fit    on the screen.    For
  54.            displays    that do    not support true-color modes,
  55.            Floyd-Steinberg dithering is used.
  56.  
  57.            ASCII graphics in the text-mode version allow a basic
  58.            view of the current rendering on    text-only terminals.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                          (printed 4/6/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))          PPPPOOOOVVVV----TTTTeeeeaaaammmm ((((4444 MMMMaaaarrrrcccchhhh 1111999999999999))))        PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))
  71.  
  72.  
  73.  
  74.            An interrupt handler allows rendering to    be interrupted
  75.            in a safe way, so that any data not currently written
  76.            to disk will be saved before exiting.  Control-C    or
  77.            SIGINT will cause a user    abort, and save    the current
  78.            rendering, before exiting.  See _k_i_l_l(_1) for more
  79.            information.
  80.  
  81.            Platform    and architecture independent rendering means
  82.            the same    scene will render in the same way on all
  83.            computers and operating systems (with the exception of
  84.            the rendering speed, of course).
  85.  
  86.  
  87.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  88.       Options can be specified with    either a leading '+' or    a
  89.       leading '-'.    Many options are switches, meaning a '+' turns
  90.       the option on, and a '-' turns the option off.  For other
  91.       options, it doesn't matter if    a '+' or a '-' is used.     Most
  92.       options cannot have spaces in    them so    you should specify ++++FFFFNNNN
  93.       rather than ++++FFFF NNNN, and    combining options is not allowed, so
  94.       ++++SSSSCCCC iiiissss vvvveeeerrrryyyy ddddiiiiffffffffeeeerrrreeeennnntttt    ffffrrrroooommmm ++++SSSS    ++++CCCC....  OOOOppppttttiiiioooonnnnssss aaaarrrreeee nnnnooootttt ccccaaaasssseeee
  95.       sssseeeennnnssssiiiittttiiiivvvveeee....
  96.  
  97.       The command-line options are shown below with    their
  98.       corresponding    INI file options.  If the same option is
  99.       specified multiple times, whether in INI files or on the
  100.       command-line,    the last such option overrides any previous
  101.       ones,    with the exception of the ++++LLLL or    LLLLiiiibbbbrrrraaaarrrryyyy____PPPPaaaatttthhhh option,
  102.       which    is cumulative.
  103.  
  104.  
  105.     PPPPaaaarrrrssssiiiinnnngggg    ooooppppttttiiiioooonnnnssss::::
  106.       IIII<_i_n_p_u_t__f_i_l_e__n_a_m_e> or    IIIInnnnppppuuuutttt____FFFFiiiilllleeee____NNNNaaaammmmeeee=_f_i_l_e
  107.            Specifies the input file    to use.     If the    input file
  108.            name is '-', the    scene description will be read from
  109.            the standard input.
  110.  
  111.       LLLL<_l_i_b_r_a_r_y__p_a_t_h> or LLLLiiiibbbbrrrraaaarrrryyyy____PPPPaaaatttthhhh=_p_a_t_h
  112.            Specifies a directory for to search for input files,
  113.            include files, fonts, and image maps, if    the specified
  114.            file is not in the current directory.
  115.  
  116.       MMMMVVVV_n._n    or VVVVeeeerrrrssssiiiioooonnnn=_f_l_o_a_t
  117.            Treat scene files as if they were version _n._n instead
  118.            of the current version.    This may be overridden from
  119.            within the scene    file.
  120.  
  121.       SSSSUUUU or    SSSSpppplllliiiitttt____UUUUnnnniiiioooonnnnssss=_b_o_o_l
  122.            Split bounded CSG unions    if children are    finite.     This
  123.            allows automatic    bounding of CSG    objects    to take    place.
  124.  
  125.       UUUURRRR or    RRRReeeemmmmoooovvvveeee____BBBBoooouuuunnnnddddssss=_b_o_o_l
  126.  
  127.  
  128.  
  129.      Page 2                          (printed 4/6/99)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))          PPPPOOOOVVVV----TTTTeeeeaaaammmm ((((4444 MMMMaaaarrrrcccchhhh 1111999999999999))))        PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))
  137.  
  138.  
  139.  
  140.            Remove unnecessary bounding objects.  This allows
  141.            automatic bounding of older scene files to take place.
  142.  
  143.  
  144.     OOOOuuuuttttppppuuuutttt ooooppppttttiiiioooonnnnssss::::
  145.       HHHH[_0_1_2_3_4_5_6_7]
  146.            Display help on command-line options for    section    0
  147.            through 7.
  148.  
  149.       HHHH_n_n or HHHHeeeeiiiigggghhhhtttt=_i_n_t_e_g_e_r
  150.            The image should    be _n_n pixels high.
  151.  
  152.       WWWW_n_n or WWWWiiiiddddtttthhhh=_i_n_t_e_g_e_r
  153.            The image should    be _n_n pixels wide.
  154.  
  155.       SSSSRRRR_n_n or SSSSttttaaaarrrrtttt____RRRRoooowwww=_i_n_t_e_g_e_r
  156.            Start the rendering at row _n_n from the top of the
  157.            screen.
  158.  
  159.       SSSSRRRR0._n_n or SSSSttttaaaarrrrtttt____RRRRoooowwww=_f_l_o_a_t
  160.            Start the rendering _n_n percent from the top of the
  161.            screen.
  162.  
  163.       EEEERRRR_n_n or EEEEnnnndddd____RRRRoooowwww=_i_n_t_e_g_e_r
  164.            End the rendering at row    _n_n from    the top    of the screen.
  165.  
  166.       EEEERRRR0._n_n or EEEEnnnndddd____RRRRoooowwww=_f_l_o_a_t
  167.            End the rendering at _n_n percent from the    top of the
  168.            screen.
  169.  
  170.       SSSSCCCC_n_n or SSSSttttaaaarrrrtttt____CCCCoooolllluuuummmmnnnn=_i_n_t_e_g_e_r
  171.            Start the rendering at column _n_n    from the left of the
  172.            screen.
  173.  
  174.       SSSSCCCC0._n_n or SSSSttttaaaarrrrtttt____CCCCoooolllluuuummmmnnnn=_f_l_o_a_t
  175.            Start the rendering at _n_n percent from the left of the
  176.            screen.
  177.  
  178.       EEEECCCC_n_n or SSSSttttaaaarrrrtttt____CCCCoooolllluuuummmmnnnn=_i_n_t_e_g_e_r
  179.            End the rendering at column _n_n from the left of the
  180.            screen.
  181.  
  182.       EEEECCCC0._n_n or SSSSttttaaaarrrrtttt____CCCCoooolllluuuummmmnnnn=_f_l_o_a_t
  183.            End the rendering at _n_n percent from the    left of    the
  184.            screen.
  185.  
  186.       CCCC or CCCCoooonnnnttttiiiinnnnuuuueeee____TTTTrrrraaaacccceeee=_b_o_o_l
  187.            Continue    a previously interrupted trace.
  188.  
  189.       PPPP or PPPPaaaauuuusssseeee____WWWWhhhheeeennnn____DDDDoooonnnneeee=_b_o_o_l
  190.            If previewing, pause when the rendering is complete
  191.            before closing the window.
  192.  
  193.  
  194.  
  195.      Page 3                          (printed 4/6/99)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))          PPPPOOOOVVVV----TTTTeeeeaaaammmm ((((4444 MMMMaaaarrrrcccchhhh 1111999999999999))))        PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))
  203.  
  204.  
  205.  
  206.       VVVV or VVVVeeeerrrrbbbboooosssseeee=_b_o_o_l
  207.            Output verbose status messages on the progress of the
  208.            rendering.
  209.  
  210.       XXXX or TTTTeeeesssstttt____AAAAbbbboooorrrrtttt=_b_o_o_l
  211.            Enable the 'q' and 'Q' keys to interrupt    a rendering in
  212.            progress.
  213.  
  214.       XXXX_n_n or TTTTeeeesssstttt____AAAAbbbboooorrrrtttt____CCCCoooouuuunnnntttt=_i_n_t_e_g_e_r
  215.            Only check every    _n_n pixels for a    user abort.
  216.  
  217.  
  218.     OOOOuuuuttttppppuuuutttt ooooppppttttiiiioooonnnnssss ---- ddddiiiissssppppllllaaaayyyy rrrreeeellllaaaatttteeeedddd::::
  219.       DDDD[0][_G_H_T] or DDDDiiiissssppppllllaaaayyyy=_b_o_o_l  PPPPaaaalllleeeetttttttteeee=_c_h_a_r
  220.            Display the rendering in    progress, optionally
  221.            specifying the palette.    The only valid X Windows
  222.            palette option is _G, which forces grayscale preview.
  223.            The X Windows palette is    based on the visual used,
  224.            whether selected    automatically by PPPPOOOOVVVV----RRRRaaaayyyy or via    the
  225.            ----vvvviiiissssuuuuaaaallll option.    SVGA options are _T for 24-bit
  226.            true-color, and _H for 15-bit high-color display,    in
  227.            addition    to the default 256-color palette.  To specify
  228.            the palette, you    must first specify the display type
  229.            (the second character, shown here as '0') for
  230.            compatibility reasons, even though it is    ignored    in
  231.            Unix versions.
  232.  
  233.       SSSSPPPP_n_n or PPPPrrrreeeevvvviiiieeeewwww____SSSSttttaaaarrrrtttt____SSSSiiiizzzzeeee=_i_n_t_e_g_e_r
  234.            Start mosaic preview with blocks    _n_n pixels square.
  235.  
  236.       EEEEPPPP_n_n or PPPPrrrreeeevvvviiiieeeewwww____EEEEnnnndddd____SSSSiiiizzzzeeee=_i_n_t_e_g_e_r
  237.            End mosaic preview with blocks _n_n pixels    square.
  238.  
  239.       UUUUDDDD or    DDDDrrrraaaawwww____VVVViiiissssttttaaaassss=_b_o_o_l
  240.            Draw vista rectangles before rendering.
  241.  
  242.  
  243.     OOOOuuuuttttppppuuuutttt ooooppppttttiiiioooonnnnssss ---- ffffiiiilllleeee rrrreeeellllaaaatttteeeedddd::::
  244.       BBBB_n_n or BBBBuuuuffffffffeeeerrrr____OOOOuuuuttttppppuuuutttt=_b_o_o_l BBBBuuuuffffffffeeeerrrr____SSSSiiiizzzzeeee=_i_n_t_e_g_e_r
  245.            Use an output buffer _n_n kilobytes in size.
  246.  
  247.       FFFF[_C_N_P_T][_n] or    OOOOuuuuttttppppuuuutttt____ttttoooo____FFFFiiiilllleeee=_b_o_o_l OOOOuuuuttttppppuuuutttt____FFFFiiiilllleeee____TTTTyyyyppppeeee=_c_h_a_r
  248.            Store the rendered image    using one of the available
  249.            formats,    namely _Compressed TGA, P_NG, _PPM, and _TGA.  PNG
  250.            format supports the _n option to specify the number of
  251.            bits per    color, where 5 <= _n <= 16.
  252.  
  253.       OOOO<_o_u_t_p_u_t__f_i_l_e> or OOOOuuuuttttppppuuuutttt____FFFFiiiilllleeee____NNNNaaaammmmeeee=_f_i_l_e
  254.            Write the output    to the file named _o_u_t_p_u_t__f_i_l_e, or the
  255.            standard    output if '-' is given as the output file
  256.            name.
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                          (printed 4/6/99)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))          PPPPOOOOVVVV----TTTTeeeeaaaammmm ((((4444 MMMMaaaarrrrcccchhhh 1111999999999999))))        PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))
  269.  
  270.  
  271.  
  272.       HHHHTTTT[_C_N_P_T_X] or HHHHiiiissssttttooooggggrrrraaaammmm____TTTTyyyyppppeeee=_c_h_a_r
  273.            Create a    CPU utilization    histogram image    in format _x.
  274.            Available formats are _Comma-separated values (CSV), P_NG
  275.            grayscale, _PPM POV heightfield, uncompressed _TGA    POV
  276.            heightfield, or _X for no    histogram generation.
  277.  
  278.       HHHHNNNN<_h_i_s_t_o_g_r_a_m__f_i_l_e__n_a_m_e> or HHHHiiiissssttttooooggggrrrraaaammmm____NNNNaaaammmmeeee=_f_i_l_e
  279.            Output the histogram to the specified file.
  280.  
  281.       HHHHSSSS_x._y    or HHHHiiiissssttttooooggggrrrraaaammmm____GGGGrrrriiiidddd____SSSSiiiizzzzeeee=_f_l_o_a_t
  282.            Divide the histogram into _x columns and _y rows of
  283.            buckets.
  284.  
  285.  
  286.     TTTTrrrraaaacccciiiinnnngggg    ooooppppttttiiiioooonnnnssss::::
  287.       MMMMBBBB_n_n or BBBBoooouuuunnnnddddiiiinnnngggg=_b_o_o_l    BBBBoooouuuunnnnddddiiiinnnngggg____TTTThhhhrrrreeeesssshhhhoooolllldddd=_i_n_t_e_g_e_r
  288.            Use automatic bounding slabs if more than _n_n objects
  289.            are in the scene.
  290.  
  291.       QQQQ_n or    QQQQuuuuaaaalllliiiittttyyyy=_i_n_t_e_g_e_r
  292.            Render at quality _n.  Qualities range from _0 for    rough
  293.            images and _9 for    complete ray-tracing and textures, and
  294.            _1_0 and _1_1 add radiosity.
  295.  
  296.       AAAA0._n or AAAAnnnnttttiiiiaaaalllliiiiaaaassss=_b_o_o_l AAAAnnnnttttiiiiaaaalllliiiiaaaassss____TTTThhhhrrrreeeesssshhhhoooolllldddd=_i_n_t_e_g_e_r
  297.            Do antialiasing on the pixels until the difference
  298.            between adjacent    pixels is less that 0._n, or the
  299.            maximum recursion depth is reached.
  300.  
  301.       AAAAMMMM_n or SSSSaaaammmmpppplllliiiinnnngggg____MMMMeeeetttthhhhoooodddd=_i_n_t_e_g_e_r
  302.            Specify the method of antialiasing used,    non-adaptive
  303.            (_n = 1),    or adaptive antialiasing (_n = 2).
  304.  
  305.       JJJJ_n._n or JJJJiiiitttttttteeeerrrr=_b_o_o_l JJJJiiiitttttttteeeerrrr____AAAAmmmmoooouuuunnnntttt=_f_l_o_a_t
  306.            Specify maximum radius, in pixels, that antialiased
  307.            samples should be jittered from their true centers.
  308.  
  309.       RRRR_n or    AAAAnnnnttttiiiiaaaalllliiiiaaaassss____DDDDeeeepppptttthhhh=_i_n_t_e_g_e_r
  310.            Set the maximum recursion depth for antialiased pixel
  311.            sub-sampling.
  312.  
  313.       UUUULLLL or    LLLLiiiigggghhhhtttt____BBBBuuuuffffffffeeeerrrr=_b_o_o_l
  314.            Use light buffer    to speed up rendering.
  315.  
  316.       UUUUVVVV or    VVVViiiissssttttaaaa____BBBBuuuuffffffffeeeerrrr=_b_o_o_l
  317.            Use vista buffer    to speed up rendering.
  318.  
  319.  
  320.     AAAAnnnniiiimmmmaaaattttiiiioooonnnn ooooppppttttiiiioooonnnnssss::::
  321.       KKKK_n._n or CCCClllloooocccckkkk=_f_l_o_a_t
  322.            Render a    single frame of    an animation with the clock
  323.            value _n._n.
  324.  
  325.  
  326.  
  327.      Page 5                          (printed 4/6/99)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))          PPPPOOOOVVVV----TTTTeeeeaaaammmm ((((4444 MMMMaaaarrrrcccchhhh 1111999999999999))))        PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))
  335.  
  336.  
  337.  
  338.       KKKKFFFFIIII_n_n    or IIIInnnniiiittttiiiiaaaallll____FFFFrrrraaaammmmeeee=_i_n_t_e_g_e_r
  339.            Specify the initial frame number    for an animation.
  340.  
  341.       KKKKFFFFFFFF_n_n    or FFFFiiiinnnnaaaallll____FFFFrrrraaaammmmeeee=_i_n_t_e_g_e_r
  342.            Specify the final frame number for an animation.     This
  343.            must be set at a    value other that 1 in order to render
  344.            multiple    frames at once.
  345.  
  346.       KKKKIIII_n._n    or IIIInnnniiiittttiiiiaaaallll____CCCClllloooocccckkkk=_f_l_o_a_t
  347.            Specify the clock value for the initial frame of    an
  348.            animation.
  349.  
  350.       KKKKFFFF_n._n    or FFFFiiiinnnnaaaallll____CCCClllloooocccckkkk=_f_l_o_a_t
  351.            Specify the clock value for the frame final of an
  352.            animation.
  353.  
  354.       SSSSFFFF_n_n or SSSSuuuubbbbsssseeeetttt____SSSSttttaaaarrrrtttt____FFFFrrrraaaammmmeeee=_i_n_t_e_g_e_r
  355.            Render a    subset of frames from an animation, starting
  356.            at frame    _n_n.
  357.  
  358.       SSSSFFFF_n_n or SSSSuuuubbbbsssseeeetttt____SSSSttttaaaarrrrtttt____FFFFrrrraaaammmmeeee=_f_l_o_a_t
  359.            Render a    subset of frames from an animation, starting
  360.            _n_n percent into the animation.
  361.  
  362.       EEEEFFFF_n_n or SSSSuuuubbbbsssseeeetttt____EEEEnnnndddd____FFFFrrrraaaammmmeeee=_i_n_t_e_g_e_r
  363.            Render a    subset of frames from an animation, stopping
  364.            at frame    _n_n.
  365.  
  366.       EEEEFFFF_n_n or SSSSuuuubbbbsssseeeetttt____EEEEnnnndddd____FFFFrrrraaaammmmeeee=_f_l_o_a_t
  367.            Render a    subset of frames from an animation, stopping
  368.            _n_n percent into the animation.
  369.  
  370.       KKKKCCCC or    CCCCyyyycccclllliiiicccc____AAAAnnnniiiimmmmaaaattttiiiioooonnnn=_b_o_o_l
  371.            Generate    clock values for a cyclic animation.
  372.  
  373.       UUUUFFFF or    FFFFiiiieeeelllldddd____RRRReeeennnnddddeeeerrrr=_b_o_o_l
  374.            Render alternate    frames using odd/even fields, suitable
  375.            for interlaced output.
  376.  
  377.       UUUUOOOO or    OOOOdddddddd____FFFFiiiieeeelllldddd=_b_o_o_l
  378.            Start a field rendered animation    on the odd field,
  379.            rather than the even field.
  380.  
  381.  
  382.     RRRReeeeddddiiiirrrreeeeccccttttiiiinnnngggg ooooppppttttiiiioooonnnnssss::::
  383.       GGGGIIII<<<<nnnnaaaammmmeeee>>>> or CCCCrrrreeeeaaaatttteeee____IIIInnnniiii=_b_o_o_l or CCCCrrrreeeeaaaatttteeee____IIIInnnniiii=_f_i_l_e
  384.            Write all INI parameters    to a file named    after the
  385.            input scene file, or one    with the specified name.
  386.  
  387.       GGGG[_A_D_F_R_S_W]<name> or <<<<SSSSttttrrrreeeeaaaammmm>>>>____FFFFiiiilllleeee=_b_o_o_l    or <<<<SSSSttttrrrreeeeaaaammmm>>>>____FFFFiiiilllleeee=_f_i_l_e
  388.            Write the stream    to the console and/or the specified
  389.            file.  The streams are _All_File (except status),
  390.  
  391.  
  392.  
  393.      Page 6                          (printed 4/6/99)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))          PPPPOOOOVVVV----TTTTeeeeaaaammmm ((((4444 MMMMaaaarrrrcccchhhh 1111999999999999))))        PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))
  401.  
  402.  
  403.  
  404.            _Debug_File, _Fatal_File, _Render_File, _Statistics_File,
  405.            and the _Warning_File.
  406.  
  407.  
  408.     XXXX WWWWiiiinnnnddddoooowwwwssss ooooppppttttiiiioooonnnnssss
  409.       In addition to the standard command-line options, the    X
  410.       Windows version recognizes additional    command-line switches.
  411.       See _X(_1) for a complete description of these options.
  412.  
  413.       ----ddddiiiissssppppllllaaaayyyy <_d_i_s_p_l_a_y__n_a_m_e>
  414.            Display preview on _d_i_s_p_l_a_y__n_a_m_e rather than the default
  415.            display.     This is meant to be used to change the
  416.            display to a remote host.  The normal dispay option
  417.            /fB+d/fP    is still valid.
  418.  
  419.       ----ggggeeeeoooommmmeeeettttrrrryyyy  [_W_I_D_T_Hx_H_E_I_G_H_T][+_X_O_F_F+_Y_O_F_F]
  420.            Render the image    with _W_I_D_T_H and _H_E_I_G_H_T as the
  421.            dimensions, and locate the window _X_O_F_F from the left
  422.            edge, and _Y_O_F_F from the top edge    of the screen (or if
  423.            negative    the right and bottom edges respectively).  The
  424.            _W_I_D_T_H and _H_E_I_G_H_T, if given, override any    previous WWWW_n_n
  425.            and HHHH_n_n settings.
  426.  
  427.       ----hhhheeeellllpppp
  428.            Display the X Windows specific options.    Use ----HHHH by
  429.            itself on the command-line to output the    general
  430.            PPPPOOOOVVVV----RRRRaaaayyyy options.
  431.  
  432.       ----iiiiccccoooonnnn
  433.            Start the preview window    as an icon.
  434.  
  435.       ----ttttiiiittttlllleeee <_w_i_n_d_o_w__t_i_t_l_e>
  436.            Override    the default preview window title with
  437.            _w_i_n_d_o_w__t_i_t_l_e.
  438.  
  439.       ----vvvviiiissssuuuuaaaallll <_v_i_s_u_a_l__t_y_p_e>
  440.            Use the deepest visual of _v_i_s_u_a_l__t_y_p_e, if available,
  441.            instead of the visual automatically selected visual.
  442.            Valid visuals are StaticGray, GrayScale,    StaticColor,
  443.            PseudoColor, TrueColor, or DirectColor.
  444.  
  445.  
  446.      RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  447.       Currently no X resource or app-default files are supported
  448.       for the X Windows options.
  449.  
  450.  
  451.      FFFFIIIILLLLEEEESSSS
  452.       PPPPOOOOVVVV----RRRRaaaayyyy version 3.1e includes    a modification which causes
  453.       the _p_o_v_r_a_y._i_n_i in the    current    directory to override the
  454.       individual setting in    ._p_o_v_r_a_y_r_c, PPPPOOOOVVVV----RRRRaaaayyyy now looks for
  455.       initial configuration    information, like the Library_Path
  456.  
  457.  
  458.  
  459.      Page 7                          (printed 4/6/99)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))          PPPPOOOOVVVV----TTTTeeeeaaaammmm ((((4444 MMMMaaaarrrrcccchhhh 1111999999999999))))        PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))
  467.  
  468.  
  469.  
  470.       settings, which gives    the location for the standard include
  471.       files, first in the environment variable $_P_O_V_I_N_I, then in
  472.       ./_p_o_v_r_a_y._i_n_i,    then in    $_H_O_M_E/._p_o_v_r_a_y_r_c, then in
  473.       /_u_s_r/_f_r_e_e_w_a_r_e/_l_i_b/_p_o_v_r_a_y_3_1/_p_o_v_r_a_y._i_n_i, which directory can
  474.       be changed at    compile-time by    modifying POVLIBDIR in the
  475.       makefile.
  476.  
  477.       POVLEGAL.DOC should be accompany all installations of
  478.       PPPPOOOOVVVV----RRRRaaaayyyy, and outlines    specific conditions and    restrictions
  479.       on the PPPPOOOOVVVV----RRRRaaaayyyy software.  A condition    of POVLEGAL.DOC
  480.       requires that    documentation, INI, and    scene files be
  481.       available to all users of PPPPOOOOVVVV----RRRRaaaayyyy  They are often installed
  482.       in /usr/freeware/lib/povray31, but may be in other locations
  483.       on some systems.
  484.  
  485.       The most recent version of PPPPOOOOVVVV----RRRRaaaayyyy and its documentation can
  486.       always be retrieved via anonymous FTP    at ftp.povray.org, or
  487.       via HTTP at http://www.povray.org/, as well as many other
  488.       locations.
  489.  
  490.  
  491.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  492.       X(1),    kill(1)
  493.  
  494.  
  495.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  496.       PPPPOOOOVVVV----RRRRaaaayyyy is Copyright (C) 1991, 1999 the POV-Ray Development
  497.       Team.     Although it is    distributed as freeware, it is NNNNOOOOTTTT
  498.       PPPPUUUUBBBBLLLLIIIICCCC DDDDOOOOMMMMAAAAIIIINNNN    software.  PPPPOOOOVVVV----RRRRaaaayyyy is subject to the
  499.       restrictions as defined in POVLEGAL.DOC.
  500.  
  501.       _X _W_i_n_d_o_w_s is Copyright (C) 1984 - 1991 the Massachusetts
  502.       Institute of Technology, and also Copyright (C) 1992 - 1996
  503.       the X    Consortium, Inc.
  504.  
  505.  
  506.      TTTTRRRRAAAADDDDEEEEMMMMAAAARRRRKKKKSSSS
  507.       _P_e_r_s_i_s_t_e_n_c_e _o_f _V_i_s_i_o_n, _P_O_V-_R_a_y, and _P_O_V-_H_e_l_p are registered
  508.       trademarks of    the POV-Ray Development    Team.
  509.  
  510.  
  511.      BBBBUUUUGGGGSSSS
  512.       The SVGA version does    not currently generate an optimized
  513.       grayscale palette for    grayscale preview, so displays using
  514.       the _G    palette    option will use    very few gray levels, and a
  515.       few non-gray colors.
  516.  
  517.       Before reporting a bug to the    authors, you should make sure
  518.       you have the latest version of the software, in case the bug
  519.       has already been fixed.  There are a large number of PPPPOOOOVVVV----RRRRaaaayyyy
  520.       users    on the USENET newsgroup
  521.       comp.graphics.rendering.raytracing that may be able to help
  522.  
  523.  
  524.  
  525.      Page 8                          (printed 4/6/99)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))          PPPPOOOOVVVV----TTTTeeeeaaaammmm ((((4444 MMMMaaaarrrrcccchhhh 1111999999999999))))        PPPPOOOOVVVV----RRRRaaaayyyy((((1111))))
  533.  
  534.  
  535.  
  536.       you with your    problem.  If you are having problems
  537.       compiling, installing, or running the    software, you should
  538.       seek help locally or on USENET, rather than from the
  539.       authors.
  540.  
  541.       If you have a    repeatable bug in the most recent version, try
  542.       to isolate the bug in    the smallest scene file    possible.  The
  543.       POV-Ray Team Co-ordinator is Chris Young, and    can be reached
  544.       at 76702.1655@compuserve.com.    Do not send large binary or
  545.       uuencoded files to Chris without first asking    permission to
  546.       do so.
  547.  
  548.  
  549.      AAAAUUUUTTTTHHHHOOOORRRRSSSS
  550.       The primary developers, in alphabetical order    are:
  551.  
  552.         Steve Anger           Dieter Bayer      Chris    Cason
  553.         Chris Dailey       Andreas Dilger      Steve    Demlow
  554.         Alexander Enzmann  Dan Farmer      Timothy Wegner
  555.         Chris Young
  556.  
  557.       Major    contributing authors, in alphabetical order are:
  558.  
  559.         Steve A. Bennett   David K.    Buck      Aaron    A. Collins
  560.         Pascal Massimino   Jim McElhiney      Douglas Muir
  561.         Bill Pulver           Robert Skinner      Zsolt    Szalavari
  562.         Scott Taylor       Drew Wells
  563.  
  564.       Other    authors    are listed in the documentation.
  565.  
  566.  
  567.      AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTT
  568.       PPPPOOOOVVVV----RRRRaaaayyyy is based on DKBTrace 2.12 by David K.    Buck and Aaron
  569.       A. Collins.
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.      Page 9                          (printed 4/6/99)
  592.  
  593.  
  594.  
  595.